home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
tex
/
dvieps.zip
/
DVIEPS.DOC
next >
Wrap
Text File
|
1988-09-19
|
23KB
|
581 lines
dvi(1L) UNIX Programmer's Manual dvi(1L)
NAME
dvieps - TeX DVI to Epson translator
SYNOPSIS
dvieps [-a] [-b] [-c#] [-d#] [-e_V_A_R=_v_a_l_u_e]...
[-f_f_o_n_t_s_u_b_f_i_l_e] [-l] [-m#]
[-o#]... [-o#:#]... [-o#:#:#]...
[-p] [-q] [-r#] [-s#] [-v]
[-x#_u_n_i_t_s] [-y#_u_n_i_t_s] [-z] dvifile1 [ dvifile2]...
DESCRIPTION
Dvieps expects the name of the DVI file on the command line,
and the extension ._d_v_i can always be omitted. As illus-
trated below, it issues a one-line identifier message and,
if no command line arguments are given, types a Unix-style
_u_s_a_g_e message.
The output file will be given the name of the ._d_v_i file, but
with suffix ._e_p_s.
As each ._d_v_i file is processed, a list of errors is printed
on the standard error unit, _s_t_d_e_r_r; this list is also saved
in a file with suffix ._e_r_r. This file is not created if
there are no errors. As each page is printed, the physical
page number and the TeX page number(s) are printed without a
following character return; after the last page, the string
``[OK]'' is printed, followed by a newline. This gives a
convenient progress report to the terminal. If it is not
wanted, then the error output can be suppressed with the -q
(quiet) option.
OPTIONS
The order of command options and DVI file names is _n_o_t sig-
nificant; all switch values apply to all DVI files. DVI
files are processed in order from left to right.
Letter case is _i_g_n_o_r_e_d in option switches: -A and -a are
equivalent.
-a Implement virtual font caching, if possible. When a
font file is opened, a buffer is allocated to contain
the entire file, and the file is then read with one
system call. This is important primarily on networked
file systems, where the many random-access calls in the
font file for small amounts of data entail substantial
network overhead. With the entire file cached in local
memory, this overhead is removed. The additional
memory required for the font file buffers amounts to
Printed 12/31/87 21 October 1987 1
dvi(1L) UNIX Programmer's Manual dvi(1L)
100K to 200K bytes (assuming the compact ._p_k font file
format), which is not excessive. If memory cannot be
allocated for a font file, then normal buffering of
small blocks is used. A trace option (-d64) is pro-
vided to monitor the font caching; see below.
-b Backwards order printing from the default. For exam-
ple, laser printers using the Canon LBP-CX print
engine normally receive pages in reverse order
because they stack printed side up. Some have page
handling mechanisms that stack them face down, and in
such a case -b will ensure that they come out in
order 1, 2, ... instead of n, n-1, n-2, ...
-c# Print # copies of each output page. Page copies are
printed consecutively; this does _n_o_t give multiple col-
lated copies of the entire job.
-d# Produce debugging output on _s_t_d_e_r_r if a non-zero value
is given. Multiple -d switches may be specified, and
one may also add values of the following possible
options to obtain the switch value:
_2 display page coordinates and metrics of each out-
put character, and print each character bitmap in
hexadecimal;
_8 print filename and open mode of each _s_u_c_c_e_s_s_f_u_l
file opening;
_1_6 print filename and open mode of each _u_n_s_u_c_c_e_s_s_f_u_l
file opening;
_3_2 show discarded off-page text;
_6_4 trace virtual font caching;
_1_2_8 trace character setting (_l_o_t_s of output).
For example, either -d8 -d16 or -d24 will trace all
attempted file openings.
-eVAR=value
Define an environment variable on the command line (see
the later section ENVIRONMENT VARIABLES). The accept-
able values for _V_A_R are _D_V_I_H_E_L_P, _F_O_N_T_L_I_S_T, _T_E_X_F_O_N_T_S,
and _T_E_X_I_N_P_U_T_S. Under normal use of the translators,
these can be set by MS-DOS set VAR=value commands.
-f_f_o_n_t_s_u_b_f_i_l_e
Define an alternate font substitution file which is to
be used instead of the default ones (see below).
Printed 12/31/87 21 October 1987 2
dvi(1L) UNIX Programmer's Manual dvi(1L)
-l Inhibit logging.
-m# Reset magnification to #. The default for low resolu-
tion printers is -m603, corresponding to 1/1.2^5 mag-
nification of 300-dot/inch fonts. By TeX conventions,
magnification 1000 corresponds to a 200-dot/inch output
device. The default magnification is always adjusted
according to the output device resolution in order to
give a normal page size, so this parameter should
rarely be required. Legal values are int((1000 or 1440
or 1500) x 1.2^(k/2) [k = -16 ... 16]; other values
will be set to the nearest in this family. Not all
fonts will be available in this wide range, and most
installations will probably have only a half dozen or
so magnifications.
Magnification values less than 25 are taken to be a TeX
magstep parameter which is applied to the standard mag-
nification for that device. For example, -m-0.5
selects a smaller size, and -m2 selects a size 1.44
times larger than normal.
-o# _o_r -o#:# _o_r -o#:#:#
Specify a page number, or range of page numbers, to be
selected for output. In the third form, the last
number is the page number step size; it is normally 1.
This option may be specified any number of times. If
it is not specified, then all pages will be printed.
Pages are numbered in order 1, 2, 3, ... in the file,
but any page number recorded by TeX on the printed page
will in general be different. Negative page numbers
count backward; -1 is the last page in the document, -2
the second last page, and so on.
As pages are selected for printing, [#{#} will be
printed on _s_t_d_e_r_r, where the first # is the sequential
page number in the file, and the second # is a string
of values of the TeX counters, \count0 through \count9,
separated by dots, with trailing zero counters dropped.
\count0 usually records the printed page number. When
the page is completely output, a closing ] will be
printed on _s_t_d_e_r_r. Any error messages from processing
of that page will therefore occur between the square
brackets. For example, -o1:3 -o12 -o17:23 -o-3:-1
would select pages 1, 2, 3, 12, 17, 18, 19, 20, 21, 22,
and 23, plus the last three pages.
Pages are processed in the order found in the DVI file;
there is intentionally no attempt made to sort them
according to the \count0 values, since different macro
packages may use this counter for different pu